Short Introduction to Plots.jl

Idea

Plots.jl is a non-traditional plotting library

  • It does not implement a "plotting backend" itself, it's a plotting API
  • The API is easily extendable via recipes

Documentation

The rapidly growing documentation is at http://docs.juliaplots.org/latest/

Backends

Plots.jl uses other plotting libraries as backends

  • PyPlot (matplotlib): Slow but dependable. Matplotlib is a very mature product. However it can be hard to install it at times.
  • GR: Feature-rich and fast, new, easy to install. Default option.
  • Plotly/PlotlyJS: Interactive and good for web
  • PGFPlots: Native LaTeX rendering

  • UnicodePlots: Plots to unicode for no-display situations

  • Each of those is a separate plotting package, with a separate API. Each has their strengths and weaknesses. However, you'd have to learn 5 API's to use them all. Plots.jl reduces that to 1 API.

  • If there is some fine grained functionality that doesn't work with Plots, you could always use the respective plotting package directly.

We will mostly rely on the default option, which is GR. More about Backends.

In [1]:
using Plots
plot(rand(4,4))  # will use the default backend: GR
Out[1]:
1 2 3 4 0.2 0.4 0.6 0.8 y1 y2 y3 y4
In [2]:
pyplot()  # change backend
plot(rand(4,4))

INFO: Recompiling stale cache file /Users/74097/.julia/lib/v0.6/PyPlot.ji for module PyPlot.
Out[2]:
In [3]:
plotlyjs() # change backend
plot(rand(4,4))

Plotly javascript loaded.

To load again call 

init_notebook(true)

Out[3]:
In [ ]:
* The PGFPlots backend can emit native `.tex` code. 
* It's just plain beautiful.
In [3]:
pgfplots()
plot(rand(4,4))
Out[3]:
In [4]:
using LaTeXStrings
plot([plot(sin,0,10,label=L"$\sin(x)$"),plot(x->sqrt(2x),0,10,label=L"$\sqrt{2x}$")]...)
Out[4]:
In [9]:
dd = vcat([[sin(i)  sqrt(2i)] for i in 0:0.01:10]...)
p = plot(dd,label=[L"$\sin(x)$",L"$\sqrt{2x}$"])
Out[9]:
In [12]:
# save this:
savefig("myfile.tex")
# savefig("myfile.pdf")
# savefig("myfile.svg")

Attributes

The attributes work with each of the backends: http://docs.juliaplots.org/latest/attributes/

Compatibility of attributes is found in this chart: http://docs.juliaplots.org/latest/supported/

I find it easiest to use this page to find the right attributes: http://docs.juliaplots.org/latest/examples/pyplot/

In [36]:
gr()  # back to GR
plot(rand(4,4),title="Test Title",label=["First" "Second" "Third" "Fourth"])
Out[36]:
1 2 3 4 0.2 0.4 0.6 0.8 Test Title First Second Third Fourth

Some Example useage

Let's try this out. Most of those examples come from the examples section of the plots website, so check it out for more.

In [5]:
# lesson 1: every column is a series
plot(rand(10))  # 1 col = 1 series
Out[5]:
2 4 6 8 10 0.2 0.4 0.6 0.8 y1
In [6]:
plot(rand(10,2))  # 2 cols = ...
Out[6]:
2 4 6 8 10 0.2 0.4 0.6 0.8 y1 y2
In [7]:
# different linetypes
plot(rand(10,2),line=(:dot,:auto),marker=([:circle :diamond]),color=[:green :orange])
Out[7]:
2 4 6 8 10 0.2 0.4 0.6 0.8 y1 y2
In [8]:
# histogram
histogram(randn(1000),nbins=20,legend=false,title="My Histogram!",ylabel="counts")
Out[8]:
-4 -2 0 2 4 0 50 100 150 My Histogram! counts
In [9]:
# add to an existing plot later...
plot(rand(100) / 3,reg=true,fill=(0,:red))
Out[9]:
20 40 60 80 100 0.0 0.1 0.2 0.3 y1
In [10]:
# ... with plot! or scatter!
scatter!(rand(100),marker=(2,:circle),color=:black)
Out[10]:
0 25 50 75 100 0.00 0.25 0.50 0.75 1.00 y1 y2

Subplots

  • We often want to build subplots, ie multiple plots in one figure.
  • Plots.jl has a convenient layout argument that you can specify.
In [11]:
plot(rand(100,4),layout = 4,legend=false)  # make 4 equal sized subplots
Out[11]:
20 40 60 80 100 0.2 0.4 0.6 0.8 20 40 60 80 100 0.2 0.4 0.6 0.8 20 40 60 80 100 0.2 0.4 0.6 0.8 20 40 60 80 100 0.2 0.4 0.6 0.8
In [37]:
# specify the size of subplots
l = @layout([a{0.1h};b [c d; e]])
plot(randn(100,5),layout=l,t=[:line :histogram :scatter :steppre :bar],leg=false,ticks=nothing,border=false)
Out[37]:
In [38]:
# we can also sequentially build plots and then stack them together
ty = [:line :histogram :scatter :steppre :bar]
p = Any[]
for typ in ty
    push!(p,plot(rand(100),t=typ,title="$typ plot"))
end
plot(p...)
Out[38]:
20 40 60 80 100 0.2 0.4 0.6 0.8 line plot y1 0.00 0.25 0.50 0.75 1.00 0 5 10 15 20 histogram plot y1 0 25 50 75 100 0.00 0.25 0.50 0.75 1.00 scatter plot y1 20 40 60 80 100 0.2 0.4 0.6 0.8 steppre plot y1 0 25 50 75 100 0.0 0.2 0.4 0.6 0.8 bar plot y1
In [39]:
# ... and we can also add to the subplots in the same way
plot!(rand(100,5),t=:scatter)
Out[39]:
0 25 50 75 100 0.00 0.25 0.50 0.75 1.00 line plot y1 y6 0 25 50 75 100 0 5 10 15 20 histogram plot y1 y7 0 25 50 75 100 0.00 0.25 0.50 0.75 1.00 scatter plot y1 y8 0 25 50 75 100 0.00 0.25 0.50 0.75 1.00 steppre plot y1 y9 0 25 50 75 100 0.00 0.25 0.50 0.75 1.00 bar plot y1 y10
In [40]:
# 3D plots
n = 100
ts = linspace(0,8Ï€,n)
x = ts .* map(cos,ts)
y = (0.1ts) .* map(sin,ts)
z = 1:n
plot(x,y,z,zcolor=reverse(z),m=(10,0.8,:blues,stroke(0)),leg=false,cbar=true,w=5)
plot!(zeros(n),zeros(n),1:n,w=10)
Out[40]:
10 20 30 40 50 60 70 80 90 100 10 20 30 40 50 60 70 80 90 100
In [41]:
# plotlyjs is hard to beat for 3D
plotlyjs()
plot(x,y,z,zcolor=reverse(z),m=(10,0.8,:blues,stroke(0)),leg=false,cbar=true,w=5)
plot!(zeros(n),zeros(n),1:n,w=10)
Out[41]:

Animations

Any plot can be animated: see https://juliaplots.github.io

Recipes

Recipes are abstract instructions for how to "build a plot" from data. There are multiple kinds of recipes. In execution order:

  • User Recipes: Provides dispatches to plotting
  • Type Recipes: Says how to interpret the data of an abstract type
  • Plot Recipes: A pre-processing recipe which builds a set of series plots and defaults
  • Series Recipes: What most would think of as a "type of plot", i.e. scatter, histogram, etc.

Since these extend Plots.jl itself, all of Plots.jl is accessible from the plotting commands that these make, and these recipes are accessible from each other.

[Series recipes are used to extend the compatibility of backends itself!]

Check out of the Plots Ecosystem!

Type Recipe Example

  • Plots.jl allows you to define type-specific plots
  • For example, here we visualize a solution obtained from DifferentialEquations.jl by just calling plot(sol)
    • This is a very powerful package by the way, so you should have a look at the excellent documentation.
  • This is a very convenient feature to plot your custom types.
In [43]:
# this is from http://docs.juliadiffeq.org/latest/tutorials/ode_example.html
using DifferentialEquations
f(u,p,t) = 1.01*u
u0=1/2
tspan = (0.0,1.0)
prob = ODEProblem(f,u0,tspan)
sol = solve(prob,Tsit5(),reltol=1e-8,abstol=1e-8)
gr()  # switch backend again
plot(sol)
Out[43]:
0.0 0.2 0.4 0.6 0.8 1.0 0.6 0.8 1.0 1.2 t u1(t)
In [44]:
# the plot function still accepts keywords to set attributes:
plot(sol,linewidth=5,title="Solution to the linear ODE with a thicker line",
     xaxis="Time (t)",yaxis="u(t) (in μm)",label="My Thick Line!")
Out[44]:
0.0 0.2 0.4 0.6 0.8 1.0 0.6 0.8 1.0 1.2 Solution to the linear ODE with a thicker line Time (t) u(t) (in ?m) My Thick Line!
In [45]:
# and we can add to the plot with plot!
plot!(sol.t, t->0.5*exp(1.01t),lw=3,ls=:dash,label="True Solution!")
Out[45]:
0.0 0.2 0.4 0.6 0.8 1.0 0.6 0.8 1.0 1.2 Solution to the linear ODE with a thicker line Time (t) u(t) (in ?m) My Thick Line! True Solution!

MomentOpt.jl

Plot and Type Recipes Together

  • StatPlots.jl is a package based on Plots.jl to produce statistical plots
  • It has dataframe support via the @df macro
  • Let's check it out.
In [46]:
# basic example
df = DataFrame(a = 1:10, b = 10*rand(10), c = 10 * rand(10))
@df df plot(:a, [:b :c], colour = [:red :blue])
Out[46]:
2 4 6 8 10 2 4 6 8 b c
In [47]:
@df df scatter(:a, :b, markersize = 4 * log.(:c + 0.1))
Out[47]:
2 4 6 8 10 2 4 6 8 10 y1
  • StatPlots provides some very nice recipes for dataframes and matrics
  • we can look at correlational patterns in a dataframe or a matrix
In [48]:
using RDatasets, StatPlots, Plots
iris = dataset("datasets","iris")
@df iris marginalhist(:PetalLength,:PetalWidth,bins=30)

WARNING: Keyword argument match_dimensions not supported with Plots.GRBackend().  Choose from: Set(Symbol[:top_margin, :group, :background_color, :yforeground_color_text, :yguidefontcolor, :seriesalpha, :legendfontcolor, :seriescolor, :ztick_direction, :zlims, :overwrite_figure, :xguidefonthalign, :normalize, :linestyle, :xflip, :fillcolor, :ygrid, :background_color_inside, :zguidefonthalign, :bins, :yscale, :xtickfontcolor, :xguide, :fillalpha, :tick_direction, :yguidefontsize, :legendfontfamily, :foreground_color, :xtickfonthalign, :x, :ytickfontrotation, :legend, :discrete_values, :ytick_direction, :xguidefontrotation, :ribbon, :tickfontrotation, :xdiscrete_values, :legendtitle, :xgridstyle, :orientation, :gridstyle, :markersize, :camera, :xforeground_color_grid, :quiver, :zticks, :markerstrokecolor, :ztickfontrotation, :ztickfonthalign, :legendfonthalign, :xtickfontsize, :levels, :zgridstyle, :foreground_color_border, :zguidefontvalign, :marker_z, :markerstrokealpha, :markeralpha, :tickfontvalign, :zguidefontcolor, :ygridlinewidth, :zlink, :zscale, :smooth, :xticks, :zguidefontsize, :y, :margin, :ytickfontcolor, :yforeground_color_border, :zguidefontfamily, :zgridalpha, :yguidefontvalign, :yguidefonthalign, :ztickfontcolor, :html_output_format, :tickfontcolor, :titlefontrotation, :legendfontvalign, :tickfontsize, :z, :yforeground_color_axis, :xtickfontrotation, :xerror, :xguidefontcolor, :primary, :guidefonthalign, :aspect_ratio, :link, :yguide, :guidefontvalign, :yguidefontfamily, :layout, :polar, :right_margin, :xlink, :series_annotations, :inset_subplots, :ytickfontsize, :tickfontfamily, :xgrid, :ygridalpha, :xtick_direction, :colorbar, :zflip, :ticks, :legendfontrotation, :linealpha, :arrow, :xtickfontvalign, :zgrid, :bar_width, :zguide, :zforeground_color_text, :weights, :xgridalpha, :ygridstyle, :fill_z, :ztickfontfamily, :markershape, :background_color_subplot, :xguidefontvalign, :markerstrokewidth, :xguidefontfamily, :gridlinewidth, :foreground_color_subplot, :xgridlinewidth, :foreground_color_text, :titlefonthalign, :yerror, :zgridlinewidth, :grid, :xguidefontsize, :xforeground_color_axis, :background_color_outside, :titlefontcolor, :line_z, :size, :projection, :zguidefontrotation, :ydiscrete_values, :seriestype, :yflip, :fillrange, :ztickfontvalign, :xlims, :xforeground_color_border, :markercolor, :ylink, :yforeground_color_grid, :color_palette, :lims, :xscale, :left_margin, :annotations, :window_title, :foreground_color_axis, :yguidefontrotation, :guidefontsize, :zdiscrete_values, :tickfonthalign, :bottom_margin, :framestyle, :scale, :zforeground_color_border, :background_color_legend, :linecolor, :foreground_color_legend, :title, :subplot_index, :flip, :titlefontvalign, :foreground_color_grid, :linewidth, :ztickfontsize, :gridalpha, :guidefontfamily, :ylims, :xtickfontfamily, :ytickfontvalign, :ytickfontfamily, :xforeground_color_text, :show, :guidefontrotation, :legendfontsize, :subplot, :label, :ytickfonthalign, :guide, :guidefontcolor, :titlefontsize, :titlefontfamily, :zforeground_color_axis, :zforeground_color_grid, :yticks])
Out[48]:
1 2 3 4 5 6 7 0.5 1.0 1.5 2.0 2.5
In [49]:
# correlation plot from a dataframe
@df iris corrplot([:SepalLength :SepalWidth :PetalLength :PetalWidth], grid = false, bins=20)
Out[49]:
0 5 10 15 SepalLength 2.0 2.5 3.0 3.5 4.0 4.5 SepalWidth 1 2 3 4 5 6 7 PetalLength 4 5 6 7 8 0.0 0.5 1.0 1.5 2.0 2.5 SepalLength PetalWidth 2.0 2.5 3.0 3.5 4.0 4.5 SepalWidth 1 2 3 4 5 6 7 PetalLength 0.0 0.5 1.0 1.5 2.0 2.5 PetalWidth
In [50]:
# corrplot from a matrix
M = randn(1000,4)
M[:,2] += 0.8sqrt.(abs.(M[:,1])) - 0.5M[:,3] + 5
M[:,3] -= 0.7M[:,1].^2 + 2
corrplot(M, label = ["x$i" for i=1:4])
Out[50]:
0 50 100 150 200 x1 2 4 6 8 x2 -10.0 -7.5 -5.0 -2.5 0.0 x3 -3 -2 -1 0 1 2 3 -3 -2 -1 0 1 2 3 x1 x4 2 4 6 8 x2 -10.0 -7.5 -5.0 -2.5 0.0 x3 -3 -2 -1 0 1 2 3 x4
In [51]:
# cornerplot for same matrix
cornerplot(M)
Out[51]:
-3 -2 -1 0 1 2 3 x1 2 4 6 8 x2 -10.0 -7.5 -5.0 -2.5 0.0 x3 -3 -2 -1 0 1 2 3 -3 -2 -1 0 1 2 3 x1 x4 2 4 6 8 x2 -10.0 -7.5 -5.0 -2.5 0.0 x3 -3 -2 -1 0 1 2 3 x4
In [52]:
school = RDatasets.dataset("mlmRev","Hsb82")
println(head(school))
@df school density(:MAch, group = :Sx)

6×8 DataFrames.DataFrame. Omitted printing of 1 columns
│ Row │ School │ Minrty │ Sx     │ SSS    │ MAch   │ MeanSES   │ Sector │
├─────┼────────┼────────┼────────┼────────┼────────┼───────────┼────────┤
│ 1   │ 1224   │ No     │ Female │ -1.528 │ 5.876  │ -0.434383 │ Public │
│ 2   │ 1224   │ No     │ Female │ -0.588 │ 19.708 │ -0.434383 │ Public │
│ 3   │ 1224   │ No     │ Male   │ -0.528 │ 20.349 │ -0.434383 │ Public │
│ 4   │ 1224   │ No     │ Male   │ -0.668 │ 8.781  │ -0.434383 │ Public │
│ 5   │ 1224   │ No     │ Male   │ -0.158 │ 17.898 │ -0.434383 │ Public │
│ 6   │ 1224   │ No     │ Male   │ 0.022  │ 4.583  │ -0.434383 │ Public │
Out[52]:
-5 0 5 10 15 20 25 0.01 0.02 0.03 0.04 Male Female
In [53]:
# use tuple of col names to group by more
@df school density(:MAch, group = (:Sx, :Sector), legend = :topleft)
Out[53]:
0 10 20 30 0.01 0.02 0.03 0.04 0.05 Male Public Male Catholic Female Public Female Catholic
In [54]:
singers = RDatasets.dataset("lattice","singer")
@df singers violin(:VoicePart,:Height,marker=(0.2,:blue,stroke(0)))
@df singers boxplot!(:VoicePart,:Height,marker=(0.3,:orange,stroke(2)))
Out[54]:
Bass 2 Bass 1 Tenor 2 Tenor 1 Alto 2 Alto 1 Soprano 2 Soprano 1 60 65 70 75 y1 y2
In [55]:
# there is great support to plot distributinos
using Distributions
plot(Normal(3,5), fill=(0, .5,:orange))
Out[55]:
-10 0 10 20 0.00 0.02 0.04 0.06 y1
In [56]:
dist = Gumbel(2)
plot(dist,lw=3,label="pdf",legend=:right,title="Dig that plot!")
scatter!(dist,func=cdf,alpha=0.3,label="cdf",xlabel="x")
vline!([median(dist)],color=:red,lw=3,label="median")
Out[56]:
0.0 2.5 5.0 7.5 10.0 0.00 0.25 0.50 0.75 1.00 Dig that plot! x pdf cdf median
In [57]:
groupedbar(rand(10,3), bar_position = :dodge, bar_width=0.7)
Out[57]:
2 4 6 8 10 0.0 0.2 0.4 0.6 0.8 y1 y2 y3
In [58]:
groupedbar(rand(10,3), bar_position = :dodge, bar_width=0.7)
Out[58]:
2 4 6 8 10 0.0 0.2 0.4 0.6 0.8 y1 y2 y3

Plots and Query

  • can combine a plot with a Query.jl pipeline
  • very nice in terms of readability:
In [59]:
df = DataFrame(a = 1:50, b = 10*rand(50), c = 10 * rand(50))
@df df scatter(:a, :b, markersize = 4 * log.(:c + 0.1))  # like before
Out[59]:
0 10 20 30 40 50 0.0 2.5 5.0 7.5 10.0 y1
In [60]:
using Query
df |>
    @filter(_.a > 5) |>
    @map({_.b, d = _.c-10}) |>
    @df scatter(:b, :d)
Out[60]:
0.0 2.5 5.0 7.5 10.0 -10.0 -7.5 -5.0 -2.5 0.0 y1
In [ ]: